MovieClip.createTextField()

Доступность

Flash Player 6.

Синтаксис

my_mc.createTextField(instanceName:String, depth:Number, x:Number, y:Number, width:Number, height:Number) : Void

Параметры

instanceName Строка-идентификатор нового текстового поля .

depth Положительное число, определяющее глубину нового текстового поля.

x Число, определяющее координату x нового текстового поля.

y Число, определяющее координату y нового текстового поля.

width Положительное число, определяющее ширину нового текстового поля.

height Положительное число, определяющее высоту нового текстового поля.

Возвращает

Ничего.

Описание

Метод; создает новое пустое текстовое поле в мувиклипе my_mc. Вы можете использовать createTextField() для создания текстовых полей во время проигрывания ролика. Параметр depth определяет глубину текстового поля в мувиклипе. На одной глубине одновременно может находиться только один объект. Если вы создаете новое текстовое поле на глубине, на которой уже есть текстовое поле, новое заместит существующее. Чтобы избежать замещения существующего объекта, используйте метод MovieClip.getInstanceAtDepth(), чтобы определить, занята ли указанная глубина, или метод MovieClip.getNextHighestDepth(), чтобы получить номер следующей свободной глубины. Текстовое поле позиционируется в точке (x, y) и имеет размеры width на height. Параметры x и y должны указываться относительно точки регистрации мувиклипа; эти параметры соответствуют свойствам _x и _y текстового поля. Параметры width и height соответствуюот свойствам _width и _height, соответственно.

По умолчанию свойства нового динамически созданного текстового поля таковы:

type = "dynamic"
border = false
background = false
password = false
multiline = false
html = false
embedFonts = false
selectable = true
wordWrap = false
mouseWheelEnabled = true
condenseWhite = false
restrict = null
variable = null
maxChars = null
styleSheet = undefined
tabInded = undefined

Текстовое поле, созданное при помощи метода createTextField(), получает по умолчанию следующий объект класса TextFormat:

font = "Times New Roman"
size = 12
color = 0x000000
bold = false
italic = false
underline = false
url = ""
target = ""
align = "left"
leftMargin = 0
rightMargin = 0
indent = 0
leading = 0
blockIndent = 0
bullet = false
display = block
tabStops = [] (empty array)

Вы можете расширять методы и обработчики событий класса MovieClip, создавая его подклассы. Для более подробной информации смотри "Присвоение класса мувиклип-символу " в Использовании ActionScript во Flash.

Пример

В примере ниже создается текстовое поле 300 на 100 пикселов, с координатой x, равной 100, координатой y, равной 100, без рамки, с красным подчеркнутым текстом:

this.createTextField("my_txt", 1, 100, 100, 300, 100);
my_txt.multiline = true;
my_txt.wordWrap = true;
var my_fmt:TextFormat = new TextFormat();
my_fmt.color = 0xFF0000;
my_fmt.underline = true;
my_txt.text = "Это текст в моем первом программно созданном текстовом поле.";
my_txt.setTextFormat(my_fmt);

Этот пример также содержится в файле animations.fla в папке HelpExamples. Следующий список показывает наиболее часто встречающиеся местоположения этой папки:

См. также

TextFormat class